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Multics Site to Another 
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AN76-02 February 1981 


Honeywell 


Preface 


This manual contains a description of the Multics Carry Facility and the 
practical aspects of its application. The facility is a useful tool that provides 
the means for transferring data (Segments, multisegment files, and directory 
subtrees) between two Multics sites. 


Reference is made in this manual to an individual designated the carry 
administrator. Depending on the needs and resources of a particular site, 
these individuals might be the system administrator or one of any number of 
qualified individuals to whom the system administrator has delegated this 
responsibility. In either case, the carry administrator requires certain privileged 
access to the system in order to perform administrative functions for the carry 
facility. The access requirements are detailed under “Carry Administrator 
Commands,” Section 5. 


_ Users of this manual should be familiar with some of the concepts and 
terminology of the Multics system. The following Multics user documentation 
should be consulted: 


Manual Name Order No. Text Reference — 
Multics Administrator Manual, System AK50 MAM System 
Multics Programmers’ Manual: 


Reference Guide AG91 MPM Reference Guide 

Commands and Active Functions AG92 MPM Commands 

Subroutines AG93 MPM Subroutines 

Subsystem Writers’ Guide AK92 MPM Subsystem Writers’ 
Guide 

Peripheral Input/Output AX49 MPM Peripheral I/0 

Communications Input/Output CC92 MPM Communications I/O 


Throughtout this manual, reference is frequently made to a number of the 
above manuals. For convenience, references to these manuals in text are in 
the form: “as described in the MPM Commands,” or “see the MPM Subroutines.” 


The information and specifications in this document are 
subject to change without notice. This document contains 
information about Honeywell products or services that may 
not be available outside the United States. Consult your 
Honeywell Marketing Representative. 


© Honeywell Information Systems Inc., 1981 File No.: 1L13 AN76-02 
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Section 2, "Carry Administrator," is new to this manual. The information 
formerly contained in Section 1, the introduction, is now divided between 
Section 1, which contains information pertinent to all users of the Carry 
Facility, and Section 2, which contains information pertinent to carry 
administrators. 


In Sections 3 and 4, the sample exec _coms and the examples shown have been 
updated to denote changes in the exec _coms. 


In Section 5, the administrator commands section, numerous’ new control 
arguments have been added to the carry_load command and the carry retrieve 
command. 


In Section 6, the user command section, numerous new control arguments have 
been added to the following command descriptions: 


cancel carry request 


enter _carry_ request 
list carry requests 
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The Multics carry facility is a means for transferring files and directory 
subtrees from one Multics site to another. This manual describes the procedures 
used to "carry" information, i.e., copy (dump) the information to be transferred 
onto a special tape, physically send the tape to the other site, and then copy 
(load) the information from that tape onto the system. 


A carry operation consists of three main steps: 


1. <A user at the sending site issues a carry request. 


2. Periodically (e.g., daily) at the sending site the carry administrator 
dumps all user requests. 


3. The carry administrator at the target site loads the tape containing the 
carried information. 


The rest of this section describes the steps taken by a user when issuing a 
carry request and briefly summarizes how the request is processed. Section 2 
describes the specific steps taken by the carry administrator when dumping and 
loading tapes. 


THE CARRY QUEUE ] 


Carry queues are message segments into which carry requests are automatically 
placed. Access to the queues is described by the letters adros: 


access to add a request | 
access to delete any request 

access to read any request 

access to read and delete one's own requests 

access to determine the total number of requests in the queue 


anotsany 


Users require "ao" access to a carry queue in order to add requests and 
list or cancel their own requests. 


ISSUING A CARRY REQUEST | 


Individual users submit (queue) requests for carrying their own entries 
using the enter_carry request command (described in Section 6). 


The carry queue is read periodically and the requested entries are dumped 
on a tape. This tape is sent to the target site, where it is loaded. 
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The process that dumps and loads carry tapes belongs to one or more carry 
administrators, users with r and d extended access to the queue. In most cases, 
there is only one carry administrator, for example Carry.Multics. 


Access required to carry an entry is: 
Ts s to all carry administrators on the parent directory. 


2. s to the user and to all carry administrators on all directories in 
any subtree being carried. 


3. r to the user and to all carry administrators on a segment being 
carried, or on all segments in a subtree being carried. 


If the user does not have sa access to the parent directory at the target 
site, the entry is not loaded and a copy is loaded instead in a directory under 
>daemon_dir_dir>carry dir>copies. The requestor receives notification if this 
happens. 


created. 


There is a destination associated with each request. Carry queues are 
named: 


<destination>.carry.ms 


and are created by the ms_create (mscr) command (described in the MAM System) 
The administrator can add the name carry.ms to one of the carry queues with the 
ms add name command (also described in the MAM System), making the queue the 
default when no destination is specified to the enter _carry request command. 


For example, if a carry administrator regularly circulates tapes between a 
site in Boston and two other sites (e.g., New York and Phoenix), he must create 
two queues to contain the requests (e.g., NY.carry.ms. and Phx.carry.ms). If 
most requests are sent to Phoenix, the administrator can add the name carry.ms 
to the queue Phx.carry.ms. Then users can send requests to Phoenix by typing 
"enter carry request <paths>", whereas users wishing to send requests to New 
York must explicitly specify that destination by typing "enter carry request 


| If any directories in the pathname of a target entry do not exist, they are 
-destination NY <paths>"., 


The default directory in which queues reside is: 


>daemon_dir_dir>carry dir 
to the enter _carry request command. 


After the user issues a request, the carry administrator performs the steps 


| This default can be overridden by specifying the -queue dir (-qd) control argument 
| summarized below to complete the carry operation. 


| AT THE SENDING SITE 


The carry administrator must have appropriate access to the entries to be 
carried and to the carry queue. (See Section 2, "Carry Administrator" for a 
listing of required access.) 
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The carry administrator makes a carry tape by issuing a command line either 
interactively or within an absentee process. When a tape is dumped, an exec com 
(see Section 3) creates a text segment for each requestor that is also dumped on 
the tape. The segment contains a listing of that users' requests. When the 
tape is loaded at the target site, each requestor receives that segment as 
notification that the administrator has loaded his requests. 


If, while dumping the tape, an access or other problem prevents a request 
from being written on the tape, the carry process prints an error message to the 
administrator and sends the requestor diagnostic mail. When the administrator 
dumps a tape, an exec com creates another text segment named <tape number>.input, 
where <tape number> is the identifier of the tape. This segment contains a 
listing of all the requests to be dumped on that tape, and can be used later by 
the carry administrator to dump a replacement tape if the original is destroyed 
or lost. 


AT THE TARGET SITE 


The carry administrator loads the carry tape by issuing a command line (see 
Section 2, "Carry Administrator" for details). 


The entry is loaded with the same pathname that the requestor specified at 
the sending site, either the original pathname or the new one specified by the 
-new_dir control argument to the enter_carry request command. Therefore, the 
request cannot be loaded at the target site if some directory in that pathname 
does not exist and the carry administrator does not have sufficient access to 
create it. Other reasons that an entry may not be loaded are lack of quota and 


lack of (requestor) access. 


When an entry cannot be loaded in the place. specified originally, a copy of 
the entry is saved in the carry hierarchy, and the requestor can copy it from 
there. The pathname of the copy has the directory name >ddd>carry dir>copies 
replacing the first two levels of the entry's pathname. For example, if the 
request: 

>udd>SysProj>Niles>styles>files 
eannot be loaded, the retrieved copy is named: 
>ddd>carry dir>copies>Niles>styles>files 


Pathnames with only one or two directory levels (e.g., >exl>o) are appended as 
is to the pathname of the copies directory (>ddd>carry dir>copies>exl>do). 
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SECTION 2 


CARRY ADMINISTRATOR 


ACCESS REQUIREMENTS 


There can be more than one carry administrator (e.g., one per site); carry 
administrators are any persons having adros access to a carry queue. Since any 
of the carry administrators can be the one to dump the requested entries, all 
carry administrators must have appropriate access to the entries, as well as to 
the queues. 

Access required at the sending site is: 


e s to all the queue's carry administrators on the parent directory of 
the entry being carried, 


® s to the requestor and to all the queue's carry administrators on all 
directories in any subtrees being carried, and 


® r to the requestor and to all the queue's carry administrators on a 
segment being carried or on all segments in a subtree being carried. 


Access recommended at the target site is: 
e sa to the requestor on the parent directory of the entry being carried. 


If this access is lacking when the entry is to be loaded, a copy is 
loaded in the copies directory instead. 


DUMPING THE TAPE 


The administrator makes a carry tape by issuing the command line: 
carry dump tape number {queue_path} {-control arg} 

or the active string: 
[carry dump tape number {queue_path} {-control_arg}] 


either interactively or within an absentee process. 


If all the room on one tape is used up, the operator mounts an additional 
tape to complete the dump. An explanatory message is sent to the carry administrator 
when this happens, and the tapes are sent together to the target site. (See the 
carry_ dump command and the -next_vol control argument to the carry load command 
in Section 5.) 


If a request cannot be dumped, the requestor receives diagnostic mail and 
the carry process prints an error message. 
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When a carry tape is destroyed or lost, a replacement can be written using 
the remake carry tape command. This command reads the input segment 
<tape number>.input created in the queue's parent directory by the carry dump 
command at the sending site. ~ 


When a tape is dumped, the directory: 

>earry dir>mail to carry 
is also dumped on that tape containing a text segment named Person id.Project_id 
for each carry requestor. When the tape is loaded at the target site, the 


segments under mail _to_carry are mailed to the requestors as notification that 
the requests have been loaded. 


LOADING THE TAPE 


The administrator loads a carry tape by issuing the command line: 
carry load tape number {-control_ args} 
or the active string: 


[earry_load tape number {-control_args}] 


The pathname of an entry as it appears on the tape is the pathname specified 
by the requestor to the enter carry request command. If some directory in this 
pathname does not exist at the target site, and the carry administrator's process 
does not have sufficient access to create it, the request is not loaded in 
place. Also, an entry is not loaded in place if there is insufficient quota or 
if the parent directory does not give sa access to both the requestor and the 
carry administrator. The copies are retrieved in the directory 
>ddd>carry dir>copies, but the carry administrator can optionally use a different 
directory for copies. 


The administrator can list the contents of a carry tape by typing: 

carry map tape number 
and can retrieve specific entries by typing: 

carry retrieve tape number paths {-control_ args} 
The -new_ dir control argument to the carry retrieve command causes the preceding 
path to be retrieved into a different directory. This is called cross-retrieval 


and is useful when quota or access restrictions prevent retrieving an entry in 
the originally specified place. 
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SECTION 3 


fog 
weit 2 


This section describes a sample carry facility using exec_com (see the MPM 
Commands) and absentee segments to dump and load tapes. The two sites in this 
example are PHX and MIT. The exec_coms are included in Section 4 of this document. 
The one called to.ec (also to.absin) runs daily as a self-submitting absentee 
job. The one called from.ec is executed by the carry administrator whenever a 
carry tape from the other site arrives at the computer room. 


The carry administrator is responsible for circulating the tapes between 
the sites, checking on the results of the absentee job to.absout at each site, 
running from.ec at each site, interacting with requestors, and handling any 
unforeseen problems that may occur while dumping or loading the tapes. 


In this example, there is only one carry administrator, named Carry.Multics. 


The tapes are numbered 50201 through 50210 and are allocated and freed by 
the manage volume pool (mvp) command, which is described in the MPM Commands. 
This command/active function frees a tape in the pool after it is loaded and 
allocates a free tape to dump. 


To write a specified tape, the calling sequence is: 
ec to <destination> <tape_ no> 
To write any free tape, the calling sequence is: 
ec to <destination> 
The latter prints a message of the form "Using tape 502XX". 
Every time to.ec (to.absin) runs under absentee, it resubmits itself for 


2:00 pm the following day. It calls the carry dump command to write on the next 
free tape. 


The carry administrator occasionally has to delay the absentee job to wait 
for important requests that must be carried that day. This is done by cancelling 
to.absin ("cancei_absentee request to”), making sure the requests are in the 
queue and then running to.ec by hand ("ec to ...") and submitting to.absin to 
run the following day: 


enter absentee request to -rt -time 1400. -rse tape drive -ag <destination> 
where the -rt (-restart) control argument causes the job to restart automatically 
in case of a crash, and the -rse (-resource) tape drive argument begins the job 
only if a tape drive is available. There is also a simple exec_com to postpone 
the absentee job: 


ec delay to <new_time> <destination> 
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When to.ec has completed a tape, it logs what it has done by calling two 
exec coms: 


ec carry logger <tape no> <to_or_from> <destination> <date_time> 


ec update carry file <tape_no> <to_or_from> <destination> 


The first exec com, carry _logger.ec, updates the user-readable segment 
XXX tapes.info, where XXX is a destination. This info segment describes the 
status of all the carry tapes that go back and forth between this site and XXX. 
Its contents look like this: 


07/28/81 1405.6 edt Tue 
Carry tape 50203 to THERE 


07/28/81 1408.1 mst Tue 
Carry tape 50208 from THERE 


07/27/81 1403.7 mst Mon 


1 
1 
{ 
t 
' 
1 
4 
i] 
' 
i] 
i 
07/27/81 1403.1 edt Mon H 
i] 
1 
i 
Carry tape 50207 from THERE H 

i 

! 

i] 

i} 

i 

{ 


i] 
1 
] 
! 
1 
{ 
1 
1 
i] 
4 
i] 
1 
{ 
t 
i 
i Carry tape 50202 to THERE 
i] 
i 
1 
I 
i] 
i] 
i 
J 
1 
i] 
1 
! 
i] 
1 


where THERE is the destination name of the other site, having the value "PHX" at 
MIT and "MIT" at PHX. 


The second exec com updates the user-readable segment to THERE.info, which 
lists the contents of only those tapes dumped at the site where the info segment 
resides. The older tapes have probably been overwritten at the other site. 
This segment is a concatenation of tape log segments written by carry dump: 


07/28/81 1405.6 edt Tue: 

Carry tape 50203 to THERE written 07/28/81 1405.6 edt Tue 
Subtree >user dir dir>Multics>Sherman>to xxxx Sherman.Sample.a 
Segment >daemon_ dir _dir>earry dir>50203. input Carry.Multics.a 


Carry tape 50201 to THERE written 07/27/81 1403.1 edt Mon 
Subtree >no_backup dir dir>SProj>Gluck>s>secrets Gluck.SProj.a 
Segment >user dir_ dir>TRLIB>Walton>thesis Walton.TRLIB.a 
Segment >user dir dir>Horrors>Cthulu>mask Cthulu.Horrors.a 
Segment >daemon_dir_dir>earry_dir>50202.input Carry.Multics.a 


H i 
H H 
{ H 
| | 
i 1 
07/27/81 1403.1 edt Mon: H 
i] 1 
{ I 
H H 


Then to.ec calls carry _archive.ec to archive the tape log segment created 
by carry dump: 


ec carry archive <tape number> <to_or from> <destination> 
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After each time to.absin has run, the administrator logs in as Carry and 
prints the contents of the segment to.absout to see whether the tape was written 
successfully. A successful run looks roughly like this, with optional lines 
preceded by a plus sign (+): 


H Absentee user Carry Multics logged in: 07/28/81 1400.8 est Tue i 
1 + From Carry.Multies 07/27/81 1406.6 edt Mon: H 
i + Tape 50210 to PHX done. (from previous day) H 
i Using tape 50201 
i + assign resource: Waiting for assignment. 
H Device tape O04 assigned 

H Mounting tape 50201 for writing 

i + := 07/28/81 1401.3 edt Tue: 

i + Starting carry dump to PHX, tape 50201 
H Mounted tape 50201 on drive 4 

carry dump: Normal termination. 
$ 

! 

t 

I 

i] 

1 

1 

i 

i] 

! 

t 

1 

i 

t 

H 


+ Search failed. (from qedx, appending to info seg) 
ID: 180340; 12 already requested. 


Absentee user Carry Multics logged out 07/28/81 1406.0 edt Tue 
CPU usage 47 sec, memory usage 717.0 units 


| 
' 
t 
! 
I 
! 
i 
>ddd>carry dir>50201.tape log 07/28/81 1404.7 edt Tue 
! 
| 
! 
| 
' 
i 
' 
! 
' 
! 


If the requested tape is not available, an appropriate error message is 
printed, for example: 


carry dump: Resource not available. 50201 


If anything goes wrong, the absentee job is automatically resubmitted for the 
next day. The administrator should check to make sure that the job has been 
queued. 


Depending on the nature of any errors that have occurred, the administrat 
may want to remake the tape by calling the remake carry tape command, 
calling remake tape.ec: 


ec remake tape <old_ tape number> <new_tape number> <destination> 
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The loading exec_com is called as follows: 
ec from <destination> <tape_ number> 


This exec _com calls carry load and then logs its results in THERE carry tapes.info 
and from_THERE.info. A successful run looks roughly like this: 


ec from PHX 50206 <administrator types this line> : 
+ assign resource: Waiting for assignment. H 
Device tape 02 assigned ‘ 
Mounting tape 50206 for reading ' 
Mounted tape 50206 on drive 2 : 
+ build tree: Incorrect access to directory. H 
+ = >udd>m>Cleary>notes 
+ ACL,ring brackets,safety switch: Incorrect access to directory. H 
+ >udd>FTP>Jensen>ftp_ 
+ Segment >udd>FTP>Jensen>ftp not loaded in place. 
carry load: Normal termination. ' 
+ 1 request not loaded in place. 


Note that >udd>m>Cleary>notes has been loaded as a copy: 


>ddd>carry dir>copies>Cleary>notes 


Any time a copy cannot be loaded for some reason, its pathname is printed at the 
end of the printed output. For example: 


i) J 
' i] 
i OF THESE, 2 COPIES NOT LOADED: i 
H >udd>m>Livingston>expedition i 
>ex1>Myths>bound_prometheus _ 


It is possible to quit out of from.ec if the specified tape cannot be found 


| 3 requests not loaded in place. 
and to execute it again later. 


When the daily dumping and loading have been completed successfully, the 
administrator can list the tapes written so far this week at each site by printing 
the segment: 

| >ddd>carry dir>THERE tapes.info 


| where THERE is the name of the opposite site. 
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It is important to remember that before running the sample exec coms for 
the first time, a value segment (for use by the value command/active function), 
a volumes segment (for use by the manage volume _pool command), and two info 
segments (for logging results) must be created. To do this, use the following 
steps. 


First, the segment Carry.value seg must be created in the home directory if 
such a segment does not already exist: 


er Carry.value_ seg 


Second, the command line: 
mvp add 502(01 02 03 O4 05 06 O7 08 09 10) 


creates a volume manager segment named Carry.volumes. Any tape that is not 
physically at that site, and therefore not available for dumping, must be set to 
an allocated state: 


mvp allocate 502XX THERE 


where THERE is a comment naming the other site. Free tapes can be listed at any 
time by typing: 


mvp list -free 


Third, two info segments, named to THERE.info and THERE tapes.info (THERE 
names the target site) must be created in dddd>carry_ dir, each initially containing 
two blank lines. Both segments should give rw access to all carry administrators 
and r access to all users of the facility. 


Fourth, a segment named >udd>m>Carry>nl must be created containing a single 
newline character. This segment is used for editing by the carry logger exec_com. 


To summarize the daily activities at the target site: 
Tess Receive incoming tape and deliver it to the computer room. 


2% (After to.absin has run for the day) log in as carry administrator at 
each site to (a) check the contents of to.absout to make sure that the 
tape was written successfully, and (b) issue the command line "lar" 
(list_absentee requests) at each site to make sure that to.absin is 
queued to dump a tape the next day. 


oP (After the incoming tape has been taken to the computer room) log in 
-asS carry administrator at target site and execute from.ec. 
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SECTION 4 


SAMPLE EXEC COMS 


The examples contained in this section illustrate the use of exec coms to 
run the Multics carry facility. These exec coms dump carry requests, remake a 
carry tape, load carry requests, log a tape and archive a list of its contents, 
and print the daily listing of carry tapes. 


The carry administrator must make sure that all of the following names are 
on the exec_com segment: 


to.ec 

to.absin 

remake tape.ec 
delay_to.ec 

from.ec 

carry logger.ec 
update carry file.ec 
carry archive.ec 
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&command line off 
&input line off 
&goto &ec name 


& 

& 

& to.ec: Dump carry requests. 
& 

& 

&label to 

& 

& Check calling sequence 

& 


&if [exists argument &1] &then &goto arg1 there 
&print Usage: ec to destination {tape_ number} 
&if [not [user absentee]] &then &quit 


sm [user name].[user project] No destination for to.absin 
sm [user name].[user project] Abs job not run or resubmitted. 


&quit 

& 

&label arg1 there 

value$set to_&1_retrying false 
& 


& Skip absentee tests for to.ec 

& 

&if [not [user absentee]] &then &goto ec_to 
& 


& Remake a tape whose creation was previously interrupted 


& 


&if [equal [value to_&1_ status] not_completed] &then &goto ec to 


value$set to_&1_ status not_completed 


9 
o 


& Remake Friday's tape on Monday not Saturday or Sunday 


& 


&if [equal [day name] Saturday] &then &goto to weekend 
&if [not [equal [day name] Sunday]] &then ‘&goto to nextday 


& 
&label to weekend 


ear to -rt -time "Monday i400" -rse tape drive -ag &1 


&print Attempt to run to.absin on weekend. 
&print Resubmitted for Monday at 1400. 

&quit 

& 

&label to nextday 

&if [equal [day_name] Friday] 

&then value$set next to &1 time "Monday 1400." 
&else value$set next to &1 time 1400. 

& 


& Resubmit absentee 
& 


ear to -rt -time [date time [value next_to_&1_ time]] -rse tape drive -ag &1 


& Both to.ec and to.absin come here 
& 

&label ec to 

value$set to &1 date [date] 


&if [not [exists argument &2]] &then &goto use default 


& 
& Tape specified; see if it's free 
& 
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&if [mvp test &2] &then &goto use tape specified 
value$set to &1_tape [mvp allocate * &7] 

string Tape &2 not available, using [value to_&1 _tape] 
&goto make tape 

& 

&label use tape specified 

value$set to &1 tape &2 

mvp allocate &2 &1 

&goto make tape 

& 


&label use default 

value$set to _&1_tape [mvp allocate * &1] 

string Using tape [value to &1 tape] 

& 

&label make tape 

&if [user absentee] &then sm [user name].[user project] 
Starting carry dump to &1, tape [value to_&1 tape] 

& 

& Call carry dump 

& 


&if [carry dump [value to_&1_ tape] >ddd>carry dir>&1.carry.ms 
-force] 

&then &goto log to 

&mvp free [value to_&1_ tape] 

&if [user absentee] &then &goto retry 

string Unable to dump tape [value to_&1_ tape] 

&quit 

& 

&label retry 

mvp allocate [value to &1 tape] ERR 

sm [user name].[user project] Unable to dump 
tape [value to_&1_tape] to &1 at [date time] 

&if [equal [value to &1 retrying] true] &then &quit 

value$set to &1 retrying true 

oe use default 


wes log to 

ec carry logger [value to &1 _tape] to &1 [date time] 

ec update _ carry file [value to_&1 _tape] to &1 Tdate time] 

ec carry_ archive [value to &ij _tape] to &1 

&if [not [user absentee]] &then &quit 

value$set to &1 status completed 

valueg$set to &1 retrying false 

sm [user name].[user project] Tape [value to_&1_ tape] to &1 done. 


&quit 

& 

& remake tape.ec : Remake a carry tape 
& 


&label remake tape 

&if [exists argument &3] &then &goto remake test 

&print Usage: ec remake tape old number new_number destination 
&quit = 

& 


&label remake test1 

&if [mvp test &2] &then &goto remake 
&print Tape &2 not availabie 

&quit 

& 

&label remake 
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&if [remake carry tape &1 &2] &then &goto finish _remake 
& 

&print Unable to make tape &2 

&quit 

& 


&label finish_remake 

mvp allocate &2 &3 

value$set to _&3 date [date] 

ec carry_logger &2 to &3 [date time] 

ec update carry file &2 to &3 Tdate_ time] 
ec carry archive &2 to &3 

&quit 

& 


& delay_to.ec : Postpone to.absin to run at a later time 

& 

&if [exists argument &2] &then &goto delay 

&print Usage: ec delay to new_time destination {tape number} 
&quit 


& 

&label delay 

car to 

ear to -rt -time "&1" -rsce tape drive -ag &f2 
&quit 

& 

: from.ec : Load carry requests 


&label from 

&if [exists argument &2] &then &goto load tape 
&print Usage: ec from destination tape number 
&quit 

& 

&label load tape 

& 

ad {not [earry_load &f2 -ds MIT]] &then &quit 


mvp free &2 
& 
value$set from_&1 date [date] 
ec carry _logger &2 from &1 [date time] 
ec update carry file &2 from &1 [date time] 
ec carry archive &2 from &1 
&print 
&quit 
& 
carry logger.ec, update carry file.ec, and carry archive.ec 


& 
& 
& Log tape in THERE tapes.info, 

& log its contents in from THERE.info 

& or to _THERE.info and archive its tape _log segment in 
& from_ THERE.archive or to_THERE. archive 

& 


& 

&label carry logger 

&attach 

&if [not [exists segment >ddd>carry dir>&3_ tapes.info]] 
&then create >ddd>carry_ dir>&3 _tapes. info 

&if [not [exists segment >ddd>earry_ dir>&2 &3.info]] 
&then create >ddd>carry_dir>&2_&3.info 

qx 

r >ddd>carry dir>&3 tapes.info 

Oi 

&4; 

Carry tape &1 &2 &3 

\f 

or Dudd>m>Carryonl 

31,$d 

w >ddd>carry dir>&3 tapes.info 

q 
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&quit 

& 

& 

&label update carry file 

&attach ¥ 

abe >ddd>carry dir>&1.tape log -ch 

qx 

r >ddd>carry dir>&2 &3.info 

/Carry tape &1/,$d 

Or >ddd>carry dir>&l.tape log 

.r Dudd>m>Carry>nl ~~ 

-r >Dudd>m>Carry>nl 

1i 

&4: 

ff 

w >ddd>carry dir>&2 &3.info 

q 

&quit 

& 

& 

&label carry archive 

an >ddd>carry dir>&i.tape log [value &2 &3 date].&1 
archive a &2 &3 >ddd>carry dir>[value &2 &3 date].&1 
dn >ddd>earry dir>[value &2 &3 date].&1 
&quit 
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This section describes commands whose use is restricted to the Carry 
Administrator. The commands are presented in alphabetical order and follow the 
syntax used throughout Multics manuals. (For details about this syntax, see the 
MPM Commands.) 
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carry dump 


Name: carry dump 


This command dumps the carry requests in a specified queue onto a specified 


tape. 


Usage 


carry dump tape number {queue_path} {-control_arg} 


where: 


1. tape number 


is the identifier of the tape to be written. 


Ze queue_path 


is the pathname of a carry queue. The default is 
>daemon_dir_dir>carry dir>carry.ms. 


3a control arg 


Notes 


ean be -force or -fe to write a tape even if there are no requests 
in the queue. If there are no requests, the tape contains only a 
segment named <tape number>.input, consisting of a header line followed 
by the line "No requests submitted." If this control argument is 


not specified, a tape is only written if one or more requests exist. 


| The carry administrator must have r and d extended access to the queue. 


Mail 


is sent to those carry requestors whose entries cannot be dumped. 


The following entries are created in the queue's parent directory and are 


dumped on 
As: 
2. 


the tape: 
An input segment named <tape number>.input listing all the carry requests. 


A tape log segment named <tape_number>.tape log listing all the requests 
that were actually written onto the tape. 


A directory —© named mail _to_carry containing a segment named 
Person _id.Project_id for each carry requestor. These segments are mailed 
at the target site by carry_load to inform users that their requests 
have been loaded. 


If the space on the tape runs out and there is more information to be 
dumped, carry dump notifies the operator to mount another tape. The operator 
mounts another tape and the dumping continues on the new tape. (This requires 
no action by the carry administrator.) 
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Example 
If an additional tape is mounted to continue dumping of one carry dump 
request, appropriate notification appears on the carry administrator's terminal: 


e 
° 


Mounting tape (another) for writing 
Mounted tape (another) on drive 4 
carry dump: Normal termination. 


The second tape is requested by the string "(another)" so that the choice 
of a tape is left up to the operator. 
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Name: carry load 


This command loads a carry tape at its target site. 


Usage 


carry load tape number {-control_ args} 
where: 


Ts tape number 
is the identifier of the tape to be read. 


2. control args 
can be chosen from the following: 


-comment STR, -com STR 
prints the message STR at the operator's console. This comment can 
be used following a tape_number argument or the -next_vol control 
argument, when an identifier for the same tape varies between sites 
(see "Notes" and "Examples" beiow). 


-copy dir path, -cpd path 
loads copies of entries under the pathname "path" when they cannot 
be loaded in place because of access or quota restrictions. The 
copies are loaded under "path" rather than under the default directory 
>ddd>carry dir>copies (see "Notes" below). 


-force, -fe 
loads the tape even if it is more than five days old. By default, 
the tape is not loaded if it is older than five days, and an error 
message is printed. 


-next_vol tape number, -nxv tape_number 
sequentially loads more than one tape (when the dumping has run onto 
additional tapes). Multiple occurrences of this control argument 
are allowed on a line. 

-queue dir path, -qd path 


specifies the pathname of the carry queue's parent directory at the 
sending site, if different from >daemon_dir dir>carry dir. 


Notes 


When a request cannot be loaded because of insufficient access or quota, a 
copy is loaded in the directory >daemon_dir_dir>carry dir>copies. This directory 
name replaces the first two levels of the entry's pathname. For example, if the 
entry: 

>udd>Demo>JRSmith>tx.archive 
cannot be reloaded, the retrieved copy is named: 


>ddd>carry dir>copies>JRSmith>tx.archive 
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If the original pathname has only one or two directory levels (e.g., >exl>o), 
the entire pathname is appended to the pathname of the default directory (e.g., 
>ddd>carry dir>copies>exl>o). 


A tape may be labelled with two different identifying numbers when each 
site has its own method of identification. The -comment control argument can be 
used by the carry administrator to specify a tape identifier at the target site 
when it is different from the identifier of the same tape at the sending site 
(see "Examples" below). 


Examples 


To load the three-volume carry tape consisting of 50204 continued on 50011 
and then on 50012 (all dumped by a single invocation of the carry dump command), 
use the -next_vol (-nxv) control argument: 

earry load 50204 -nxv 50011 -nxv 50012 


The above command line loads sequentially the three designated tapes in the 
order shown. 


To load the two-volume carry consisting of 50207 continued on 50201, where 
50207 is registered at the target site as TX653 and 50201 as TX647, use the 
-comment control argument along with the -next_vol control argument: 


carry load 50207 -com TX653 -nxv 50201 -com TX647 
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carry map carry map 


Name: carry map 


This command reads a carry tape and lists its contents. 


Usage 


carry_map tape number {-control_arg} 


where: 
hee tape number 
is the identifier of the tape. 
2. control _ arg 
can be of the form: 
-next_vol tape number, -nxv tape number 
sequentially loads more than one tape (when the dumping has run onto 
additional tapes). Multiple occurrences of this control argument 
are allowed on a line. 
Note 


The table of contents is contained in the text segment: 
>daemon_dir _dir>carry dir>TAPE NUMBER.archive 
which is retrieved from the tape and printed. An example is: 


Carry tape 50207 to PHX written 07/13/81 1401.1 edt Tue 

Segment >daemon_dir dir>carry dir>50207.input Carry.Multics 

Subtree >user_dir_dir>DEV>Franks>carry dir Franks.DEV 

Segment >user_ dir _dir>Multics>Smedley>MTB662 Smedley.Multics -move 
Move to >udd>m>Smedley>bk1 

Segment >user_dir_dir>MC>Aiken>formulas.pln Aiken.MC 
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Name: carry retrieve 


This command loads specified entries from a carry tape and optionally moves 
them to different pathnames. 


Usage 


carry_retrieve tape number paths {-control_args} 
where: 


1. tape number 
is the identifier of the tape to be read. 


2% paths 
are the pathnames of storage system entries to be loaded. 


3% control args 


ean be chosen from the following: r 
-new_dir dir path, -nd dir_path 
“loads the entry of the preceding path argument under the directory 
specified by dir_path instead of under its original parent (at the 
target site). 
-next_vol tape number, -nxv tape_volume 
sequentially loads more than one tape (when the dumping has run onto 
additional tapes). Multiple occurrences of this control argument 
are allowed on a line. 
-select 
prints a line-numbered table of contents for the tape, then asks a 
single query of the form "Request numbers:", and accepts line numbers 
of requests to be retrieved (see "Examples" below). 


Notes 


The requestor requires sa access to the (target) parent directory of each 
entry to be retrieved. If the requestor lacks m access to the parent, an error 
message states that the entry's ACL, ring brackets, and safety switch cannot be 
loaded. . 


Examples 


The command line: 

carry retrieve 50206 one two -new_dir nd three -new_dir nd four 
retrieves the entries named one and four in the working directory and retrieves 
the entries named two and three in the directory named nd, under the working 


directory. It is assumed that all the entries were in the current working 
directory when they were dumped. 
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The command line: 
carry retrieve 50206 -select 


reads tape 50206, prints a list of the requests contained on the tape, and then 
prints a query of the form "Request numbers:". The carry administrator answers 
this query with a single line of input, consisting of the line numbers as shown 
on the list just printed. The line numbers must be separated by spaces and can 
optionally be interspersed with "-new_dir path" control arguments to cross-retrieve 
entries to different directories. For example: 


carry retrieve 50206 -select <administrator requests retrieval> 
Mounting tape 50206 for reading 
Mounted tape 050206 on drive tape 02 


Carry tape 50206 to MIT written 02/03/81 1302.5 mst Tue 


Segment >daemon dir dir>earry dir>50206.input Carry.Multics 
Subtree >udd>SysProj>New>LIB107-B Smith.SysProj 

Subtree >udd>SysProj>New>comp dir Jones.SysProj 

Segment >udd>m>Disturbed>reginald Frank.Multics 

Segment >udd>Hometeam>Manager>scores Ryan.Hometeam 


ON Fuwhy—- 


Request numbers: 3 4 -nd >udd>Flames>Old 5 


which retrieves lines 3 and 5, and cross retrieves line 4 into the directory 
>udd>Flames>Old. 
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Name: carry total 


This active function returns the number of queued carry requests. 


Usage 


[earry total {-control_args}] 
where control_args can be chosen from the following: 
-admin 
returns the total number of requests. The default is the number of 
the user's own requests. 


-destination STR, -ds STR 
specifies the queue STR.carry.ms instead of the default queue carry.ms. 


-queue dir path, -qd path 
Specifies the pathname of a directory in which carry queues reside. 
By default, this directory is >daemon_dir_ dir>carry dir. 


Note 


The carry administrator must have status permission on the queue in order | 
to use the -admin control argument. 
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Name: remake carry tape 


This command rewrites a carry tape using the input segment <tape_number>.input 
from a previous carry dump. 


Usage 


remake carry tape tape_number {new_number} {-control_arg} 


where: 
1. tape_number 
is the identifier of a previously written tape for which the input 
i segment <tape_number>.input exists in the directory >ddd>carry dir. 
2. new_number 


is the identifier of the tape to be written, if different from 
tape number. 


3. control arg 
can be of the form: 


~queue dir path, -qd path 


specifies the directory containing the input segment. By default, 
this directory is >daemon_dir_dir>carry dir. 
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SECTION 6 


USER COMMANDS AND ACTIVE FUNCTIONS 


This section describes the commands and active functions pertaining to the 
Multics carry facility that are available to general users of the facility as 
well as to administrators. Commands whose use is restricted to the Carry 
Administrator can be found in Section 4. The descriptions are presented in 
alphabetical order and follow the syntax used throughout Multics manuals. (For 
details about this syntax, see the MPM Commands.) 
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Name: cancel _ carry request, cer 


This command cancels requests queued by the enter carry request command. 


Usage 
| cer {paths} {-control_args} 
where: 
Is paths 
are the pathnames of segments and directories. The star convention 
is allowed. 
2. control args 
can be chosen from the following: 
-admin, -am 
allows any user's requests to be cancelled. This control argument 


requires r and d extended access to the queue. By default, only the 
user's own requests can be cancelled. 


-destination STR, -ds STR 
specifies a destination site, where STR is up to 23 characters long. 
The carry queue searched is named STR.carry.ms. If no destination 
is specified, the queue is named carry.ms, the name added to the 
queue for the default destination. 


-entry STR, -et STR 
specifies the entryname (STR) of the request to be cancelled, instead 
of its entire pathname. (See "Notes" below.) The star convention 
is allowed. 


-~queue_ dir path, -qd path 


specifies the queue's parent directory. The default is 
>daemon_dir_dir>carry dir. 
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Notes | H 


At least one path or -entry argument must be specified. i 


starname, there must be only one request with that entryname in the queue (e.g., 


If the -entry control argument is used and the STR specified is not a 
you should not have a request with the same entryname in a different directory). 


See also the enter_carry request and list carry requests commands. 


Example j 


To cancel a carry request for the segment >udd>m>Charles>work>system.ec, | 


type: 
ecr -entry system.ec j 
To cancel all of your own carry requests, type: . 1] 
cer -entry ** j . 
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Name: 


enter carry request, ecr 


This command queues a segment or directory subtree to be carried to another 


Site. 


Usage 


ecr paths {-control_args} 


where: 

ry paths 
are pathnames of segments or directories. In the case of a directory, 
the entire subtree is carried. The star convention is allowed. 
Starnames queue separate requests for each matching segment, 
multisegment file, and directory. 

2. control args 


ean be chosen from the following: 


-destination STR, -ds STR 
specifies a destination site, where STR is up to 23 characters iong. 
The carry queue used is named STR.carry.ms. If no destination is 
specified, the request is placed in carry.ms, the name added to the 
queue for the default destination. 


-new dir dir path, -nd dir path 
“loads the entry of the preceding path argument under the directory 
specified by dir path instead of under its original parent (at the 
target site). — 


-notify, -nt 
sends notification to the requestor when the request is dumped. 


-no_ notify, -nnt 
suppresses sending of notification when the request is dumped. This 
is the default. 


-no trim 
~ suppresses the deletion (when requests are loaded at the target site) 
of target subtree entries that do not appear in the corresponding 
subtrees at the sending site. This is the default. 


-queue dir path, -qd path 
specifies the queue's parent directory. The default is 
>daemon dir _dir>carry dir. 


-trim 


deletes entries in subtrees at the target site that do not exist in 
the carried subtrees. The default is -no_trim. 
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Notes 


-user User id 


specifies the owner of the carried entries at the target site, if 
different from the requestor. User id is of the form 
Person id.Project_id. This control argument sets access to the carried 
entries at the target site for User _id rather than for the requestor, 
and sends notification to User id rather than to the requestor. This 
control argument is needed if the requestor is registered on adifferent 
project or with a different name at each of the two sites. 


See also the list_carry requests and cancel carry request commands. 
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Name: list carry requests, ler 


This command lists requests queued by the enter carry request command. 


Usage 


ler {-control args} 
where control args can be chosen from the following: 


-admin, -am 
lists all the requests. This control argument requires r extended 
access to the queue. By default, only the user's own requests are 
listed. 


-all, -a 
lists requests in all carry queues (in the default directory queue 
or the one specified by the -queue dir control argument) to which 
the user has r or o extended access. 


-destination STR, -ds STR 
lists only requests specified for destination site STR, where STR is 
up to 23 characters long. Thecarry queue listed is named STR.carry.ms. 
If no destination is specified, the queue is named carry.ms, the 
name added to the queue for the default destination. 


-queue_ dir path, -qd path 
lists only requests specified by the queue's parent directory. The 
default is >daemon_dir_ dir>carry dir. 


Note 


See also the enter_carry request and cancel carry request commands. 


6-6 AN76-02 


INDEX 


administrator 2-1 
access requirements 2-1 
dumping tapes 2-1 
loading tapes 2-2 
administrator commands 5-1 
carry dump 5-2 
earry load 5-4 
carry map 5-6 
carry retrieve 5-7 
carry total 5-8 
remake carry tape 5-9 


cancel carry request 6-2 


carry facility 
see Peripheral I/0 


carry request 1-1 
carry tape 1-1 
carry dump 5-2 
carry load 5-4 
carry map 5-6 
carry retrieve 5-7 
carry total 5-8 
commands 


see user commands or administrator 
commands 


dumping tapes 2-1 


enter_carry request 6-4 


issuing request 1-1 


list_carry requests 6-6 


loading tapes 2-2 


queue 


remake | 


sample 


sample 
list 
list 


1-1 


carry tape 5-9 


earry facility 3-1 


facility exec_coms 3-2 
of contents of tapes sent 


3-2 


of tapes received and sent 3-2 


user commands 6-1 
cancel carry request 6-2 
enter carry request 6-4 


list_ 


carry requests 6-6 
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